Criando uma conta na Meta e Twilio para o canal WhatsApp

---

Pré-requisito

Antes de iniciar o processo de ativação do número de WhatsApp no Twilio é necessário possuir os seguintes requisitos:

Conta Facebook verificada

O primeiro passo é garantir que sua conta de Facebook no Gerenciador de Negócios esteja marcada como “Verificada”. Para mais informações acesse, o nosso blog, guia para verificação de sua conta no gerenciador de negócios do Facebook.

IMPORTANTE:

• Uma conta de Facebook poderá ter vários números de WhatsApp oficial habilitados.
• Esses números podem inclusive ser de brokers diferentes.

Conta Twilio criada

O passo seguinte é criar uma conta no site do Twilio (twilio.com). A conta é necessária para consultar/emitir relatórios de envio/recebimento de mensagens pelo Twilio, cadastrar as mensagens modelos/templates a serem utilizadas nas comunicações de ativo, configurar os novos números de WhatsApp Oficial habilitado no WhatsApp Business Account – WABA disponível e  fazer a recarga de créditos para que possam custear as mensagens trafegadas. Lembrando que o serviço do Twilio é pré-pago e a recarga é feita em dólares: cartão de crédito internacional, transferências bancárias.

Clique em “Create New Account” e na tela que será carregada informe o nome de identificação da conta de aplicativo e o uso como “Twilio”.

Logo após, selecione o país e clique em “Create new account”.

Seguindo, é solicitado o preenchimento de um formulário para definição de uso da conta de aplicativo.

Vale reforçar que a imagem abaixo é para fins de representação e cada empresa pode ter uma necessidade de uso diferente, finalizando o preenchimento clique em “Comece a usar a Twilio”.

Por fim, a conta estará criada.

Vinculação do número de WhatsApp no Twilio

Próximo passo será vincular o número no WABA vinculada no Twilio.

IMPORTANTE:

• O número a ser habilitado no Twilio não pode estar sendo usado no WhatsApp.
• Ao habilitar o número no Twilio, ele não poderá mais ser habilitado no WhatsApp Emulado.
• No Twilio é possível vincular um ou mais número(s) de WhatsApp à um WABA na sua conta, porém não é possível vincular mais de um WABA na sua conta.

Após acessar a sua conta da Twilio, você deverá selecionar a conta de aplicativo que deseja vincular o novo número, cada conta de aplicativo disponível pode representar um WABA para vinculo dos números de WhatsApp que serão trabalhados.

Ao entrar na conta de aplicativo desejada, no menu lateral, na opção “Messaging”, clique em “Senders” e depois na opção “WhatsApp senders”. A partir dessa instrução, na tela será apresentado todos os números de WhatsApp vinculados no WABA da conta de aplicativos.

Caso não esteja habilitada a opção “Messaging”, no menu lateral, clique em “Explore Products” e clique na opção “Messaging” para que possa aparecer no menu lateral ou clique ícone do pin para fixa-lo no menu lateral.

Para adicionar um novo número de WhatsApp, clique no botão “Create new sender”, a partir desta ação você terá que realizar dois procedimentos, são eles:

Selecionar um número de telefone para registro

Será apresentada duas opções:

• Twilio phone number: Para provisionar um número fornecido pela própria Twilio.
• My own phone number: Para informar um número próprio que será utilizado como conta de WhatsApp.

Selecione a opção “My own phone number”, e no campo informe o número de telefone que será utilizado (Utilizar o formato E.164 – Cod. País + DDD + Número. Ex.: 5588912341234 ou 558830445566), após clique em continuar para seguir para a próxima etapa.

Integrando a aplicação do Twilio com o Tactium

Para iniciar as configurações do novo serviço no TACTIUM será necessário obter 4 informações presentes na conta do Twilio para realizar a efetivação do vinculo de comunicação entre as plataformas, são elas:

• ACCOUNT SID
• AUTH TOKEN
• ID SERVIÇO

Dados do Portal Twilio

As informações referentes a ACCOUNT SID e AUTH TOKEN são encontradas na tela de console “Account Dashboard” na aba “Account Info”.

Já o ID SERVIÇO será encontrado no “Messaging Services”:

Com essas informações em mão, podemos configurar a integração com o serviço de WhatsApp na Tactium.

Configurar o Webhook no Portal do Twilio

Após a vinculação do número será necessário criar o serviço de mensagens (Webhook) para realizar as devidas conexões com o ambiente TACTIUM.

Acesse, no menu lateral, a opção “Services” dentro da aba “Messaging”. Nesse processo será listado todos os serviços de mensagens da sua conta de aplicativo.

Para criar um novo clique em “Create Messaging Service” e preencha as 4 etapas da seguinte forma:

Etapa 1: Criando o serviço de mensagens

Informe o nome do serviço e selecione o motivo de uso dele, podendo ser “Market my services” ou “Notify my users”.

Etapa 2: Adicionar o número para o serviço

Nesta etapa, você terá que vincular o número que usará este serviço de mensagens, para isso clique em “Add Senders” e selecione a opção “WhatsApp Number”.

É possível vincular um ou mais números de WhatsApp no mesmo serviço de mensagens.

Etapa 3: Configurar integração

Nesta etapa, deverá ser realizado o apontamento do webhook do ambiente TACTIUM. Para isso selecione a opção “Send a webhook” e nos campos “Request URL” e “Callback URL” informe a URL do seu Webhook seguido com o complemento: /hook/messageTwilio e o método de conexão é o “HTTP Post”.

Normalmente as URLs do Webhook possuem o seguinte formato: https://SiteDomínioDoCliente/Omni/Webhook/hook/messageTwilio

Etapa 4: Informações de conformidade (opcional)

Por ultimo temos a etapa de conformidade que é opcional e pode ser desconsiderada, para finalizar clique em “Completar configuração do serviço de mensagens”.

Nesta etapa a Twilio permite a realização do registro US A2P de números de código longo de 10 dígitos, o A2P 10DLC é um sistema nos Estados Unidos que permite que as empresas enviem mensagens Application-to-Person (A2P) usando números de telefone de código longo de 10 dígitos (10DLC). O registro para mensagens A2P melhorará a qualidade da entrega e reduzirá a filtragem.

Para saber mais acesse How do I register to use A2P 10DLC messaging?.

 

Para mais informações verificar:

• Configurando o Webhook do Tactium Omni.
• De quais endereços IP virão as solicitações da Twilio?.

Configurando um template para envio de mensagem

Para iniciar uma mensagem ativa no WhatsApp, torna-se necessário a criação das mensagens templates que são usadas para abrir uma sessão por iniciativa da empresa. Para mais informações acesse Configurando Template na Twilio para ativo do WhatsApp no Tactium OMNI.

Cadastrando pergunta com botões

Vale ressaltar que para as integrações com a Twilio para utilizar a opção de “Pergunta com botões” (Sim ou Não e Opções customizadas) é necessário que o TACTIUM esteja com a versão igual ou superior a 5.53.8.2 e realizar os seguintes procedimentos:

• Cadastrar 3 templates no seguinte modelo:

Esses templates não serão aprovados para iniciar uma conversa com um usuário, pois não possuem o suporte “WhatsApp Business Initiated” e, portanto, não são considerados válidos. Eles terão apenas o suporte “WhatsApp User Initiated” e serão utilizados exclusivamente dentro do contexto do Script de Automação para o envio de mensagens com botões.

• É importante se atentar que será necessário criar os templates, sendo um template com 1 botão, outro template com 2 botões e um template com 3 botões, sendo cada variável usada para a construção do mesmo, o {{1}} o texto da pergunta, {{2}} o primeiro botão, {{3}} o segundo botão, {{4}} o terceiro botão.
• Após a criação e liberação dos templates, por parte da META, os mesmos terão que ser habilitados no serviço. Para isso acesse o Manager Admin, vá nas configurações do serviço integrado ao Twilio, acesse a aba “Integração” e clique no botão “Templates”. Ao abrir a tela localize os templates criados e habilite os mesmos da seguinte forma:
• Reforçando, que no “Tipo de Uso” deve ser selecionado a opção “Pergunta com botões…” de acordo com o template, depois, basta criar ou vincular o script de automação no serviço normalmente.

Caso queira saber mais informações:

• Script de Automação: Configurando um Script de Automação no Tactium Omni.
• Configurar templates no Twilio: Configurando Template na Twilio para ativo do WhatsApp no Tactium OMNI.
• Endereços IP: De quais endereços IP virão as solicitações da Twilio?.

Cadastrando lista de opções

Vale ressaltar que para as integrações com a Twilio para utilizar a opção de “Lista de Opções” (Mais de 3 botões de resposta) é necessário que o TACTIUM esteja com a versão igual ou superior a 5.54.1.1 e realizar os seguintes procedimentos:

• Cadastrar 10 templates, devendo cada um incluir uma lista de opções, com a quantidade de respostas variando de 1 a 10. Por exemplo: 1 template com uma única resposta, 1 template com duas respostas, e assim por diante.

 

Esses templates não serão aprovados para iniciar uma conversa com um usuário, possuindo apenas o suporte “WhatsApp User Initiated” e serão utilizados exclusivamente dentro do contexto do Script de Automação para o envio de mensagens com botões.

• É importante se atentar que será necessário criar os templates, cada template deve incluir uma lista de opções, com a quantidade de respostas variando de 1 a 10, com variáveis no corpo da pergunta e das respostas. Por exemplo: o {{1}} o texto da pergunta, {{2}} o primeiro botão, {{3}} o segundo botão, {{4}} o terceiro botão, {{5}} o quarto botão e assim sucessivamente.
• Após a criação e liberação dos templates, por parte da META, os mesmos terão que ser habilitados no serviço. Para isso acesse o Manager Admin, vá nas configurações do serviço integrado ao Twilio, acesse a aba “Integração” e clique no botão “Templates”.
• Ao abrir a tela localize os templates criados e habilite os mesmos da seguinte forma:

• Reforçando, que no “Tipo de Uso” deve ser selecionado a opção “Lista de Opções…” de acordo com o template.
• Após, basta criar ou vincular o script de automação no serviço normalmente.

Caso queira saber mais informações:

• Script de Automação, acesse a página Configurando um Script de Automação no Tactium Omni.
• Como cadastrar um template: Configurando Template na Twilio para ativo do WhatsApp no Tactium OMNI.

Configurando o Serviço no Tactium OMNI

A configuração do serviço deverá ser realizada a partir do CRM Admin. Para mais informações de como realizar esse processo acesse a documentação Realizando a configuração de um serviço de WhatsApp no Tactium OMNI.